…fication deep link handler (#25607)

<!--
Please submit this PR as a draft initially.
Do not mark it as "Ready for review" until the template has been
completely filled out, and PR status checks have passed at least once.
-->

## **Description**

<!--
Write a short description of the changes included in this pull request,
also include relevant motivation and context. Have in mind the following
questions:
1. What is the reason for the change?
2. What is the improvement/solution?
-->

This PR implements a deeplink handler for Card KYC push notifications,
allowing users to be routed to the appropriate screen based on their KYC
verification status when tapping on a notification about their
verification result.

**Motivation**: When users complete their KYC verification process, they
receive push notifications about the result. Previously, there was no
handler to deep link users directly to the relevant screen based on
their verification status.

**Solution**: 
- Added a new `card-kyc-notification` deeplink action that checks the
user's KYC verification state and navigates accordingly
- Handles two scenarios:
1. **Onboarding flow** (user has onboardingId): Routes to KYCFailed,
Complete (→ PersonalDetails), or KYCPending
2. **Authenticated flow** (user is already logged in): Routes to
KYCFailed, Complete (→ CardHome via SpendingLimit), or CardHome
- Updated the `Complete` screen to accept a `nextDestination` route
param for proper navigation after KYC approval
- Added logic to suppress the "keep going" modal when users are
deeplinked directly to the Complete screen
- Added `logout` method to CardSDK for proper session cleanup
- Refactored `useCardProviderAuthentication` to get location from Redux
selector instead of function parameters

## **Changelog**

<!--
If this PR is not End-User-Facing and should not show up in the
CHANGELOG, you can choose to either:
1. Write `CHANGELOG entry: null`
2. Label with `no-changelog`

If this PR is End-User-Facing, please write a short User-Facing
description in the past tense like:
`CHANGELOG entry: Added a new tab for users to see their NFTs`
`CHANGELOG entry: Fixed a bug that was causing some NFTs to flicker`

(This helps the Release Engineer do their job more quickly and
accurately)
-->

CHANGELOG entry: Added deeplink handler for Card KYC push notifications
to route users to appropriate screens based on verification status

## **Related issues**

Fixes:

## **Manual testing steps**

```gherkin
Feature: Card KYC Notification Deeplink Handler

  Scenario: User taps KYC approved notification during onboarding
    Given user is in the Card onboarding flow with a pending KYC verification
    And user has an onboardingId stored in Redux

    When user taps on a push notification with the card-kyc-notification deeplink
    And the KYC status is VERIFIED
    Then user is navigated to the Complete screen
    And tapping Continue navigates to PersonalDetails

  Scenario: User taps KYC approved notification when authenticated
    Given user is authenticated with the Card provider
    And user has completed KYC verification

    When user taps on a push notification with the card-kyc-notification deeplink
    And the KYC status is VERIFIED
    Then user is navigated to the Complete screen
    And tapping Continue navigates to SpendingLimit screen

  Scenario: User taps KYC rejected notification
    Given user has submitted KYC verification
    
    When user taps on a push notification with the card-kyc-notification deeplink
    And the KYC status is REJECTED
    Then user is navigated to the KYCFailed screen

  Scenario: User taps notification while KYC is still pending
    Given user has submitted KYC verification
    
    When user taps on a push notification with the card-kyc-notification deeplink
    And the KYC status is PENDING
    Then user is navigated to the KYCPending screen (onboarding) or CardHome (authenticated)
```

## **Screenshots/Recordings**

<!-- If applicable, add screenshots and/or recordings to visualize the
before and after of your change. -->

### **Before**

<!-- [screenshots/recordings] -->

### **After**

<!-- [screenshots/recordings] -->

## **Pre-merge author checklist**

- [x] I've followed [MetaMask Contributor
Docs](https://github.com/MetaMask/contributor-docs) and [MetaMask Mobile
Coding
Standards](https://github.com/MetaMask/metamask-mobile/blob/main/.github/guidelines/CODING_GUIDELINES.md).
- [x] I've completed the PR template to the best of my ability
- [x] I've included tests if applicable
- [x] I've documented my code using [JSDoc](https://jsdoc.app/) format
if applicable
- [x] I've applied the right labels on the PR (see [labeling
guidelines](https://github.com/MetaMask/metamask-mobile/blob/main/.github/guidelines/LABELING_GUIDELINES.md)).
Not required for external contributors.

## **Pre-merge reviewer checklist**

- [ ] I've manually tested the PR (e.g. pull and build branch, run the
app, test code being changed).
- [ ] I confirm that this PR addresses all acceptance criteria described
in the ticket it closes and includes the necessary testing evidence such
as recordings and or screenshots.

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> **Medium Risk**
> Adds new deeplink-driven navigation paths and changes how card
auth/logout manage tokens and location, which can affect user routing
and session handling. Risk is mitigated by extensive new/updated tests
but touches core Card flows and deep link handling.
> 
> **Overview**
> Adds a new `card-kyc-notification` deeplink action and handler that
routes users to the appropriate Card screen based on KYC verification
state, accounting for onboarding vs already-authenticated sessions and
ensuring the correct US/International location is used for provider API
calls.
> 
> Updates onboarding/navigation to support this deeplink flow by adding
a `nextDestination` param to the `Complete` screen, suppressing the
“keep going” modal when deeplinking directly to `Complete`, and
adjusting the onboarding header close behavior to reset navigation back
to `CardHome`.
> 
> Improves session cleanup by introducing `CardSDK.logout()` (server
logout + always-clear local token), showing a session-expired toast on
auth errors in `CardHome`, and refactoring card authentication to source
`location` from Redux (and persist it via selection) rather than passing
it through login/OTP call parameters; copy updates add clearer phone/SSN
guidance and fix onboarding button text.
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
d31a4e4. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

---------

Co-authored-by: Alejandro Machado <alejandro@macha.do>
Co-authored-by: Kevin Le Jeune <kevin.le-jeune@consensys.net>